home *** CD-ROM | disk | FTP | other *** search
/ Celestin Apprentice 2 / Apprentice-Release2.iso / Source Code / Libraries / VideoToolbox 94.11.17 / Video bugs < prev    next >
Encoding:
Text File  |  1994-11-17  |  10.5 KB  |  112 lines  |  [TEXT/ttxt]
  1. VideoToolbox: Video bugs
  2. November 17, 1994
  3.  
  4. Other than reading and writing pixels, all access to a video device normally goes through the software video driver. (You can use VideoToolbox SetEntriesQuickly.c to bypasses the video driver of a few devices, but I don't recommend that except as a last resort, because then your program will only work with the few video devices that SetEntriesQuickly supports.) The video driver is normally supplied in ROM on the video card or, for built-in video, in the computer's ROM. Many drivers have subtle bugs that TimeVideo has uncovered and documented. This file is a complete list of all the bugs that I know of. If your driver is not listed, please run TimeVideo and send me the report. 
  5.  
  6. I have the very strong impression that reporting these bugs to the manufacturers has led them to eliminate the bugs in subsequent versions. Before TimeVideo there was no easy way to test for most of these bugs.
  7.  
  8. 1. The following drivers crash if one attempts to make a get-entries request.  GDGetEntries tests for these driver names and version numbers in order to avoid these bugs. Try the demo TestGDVideo.
  9. •Mac IIci “Macintosh II Built-In Video” (.Display_Video_Apple_RBV1)
  10. (Reported to Apple MacDTS 3/7/90 and Apple.Bugs 12/30/92)
  11. •Relax 19" Model 200 (.Color_Video_Display version 9288). (Reported to Relax Tech. 1/19/93)
  12.  
  13. 2. The following drivers take too long (more than 1 frame) to load the clut (i.e. set-entries request: GDSetEntries). And many suppress one or more frame's worth of VBL interrupts each time they load the clut. Try TimeVideo.
  14. •Apple 4•8 and 8•24 “Macintosh Display Card” (.Display_Video_Apple_MDC) and
  15. “Macintosh Display Card 8•24 GC” (.Display_Video_Apple_MDCGC) take two frames to load the clut (and suppress one vbl interrupt) in all modes. (Reported to Apple.Bugs 12/30/92)
  16. •Radius PrecisionColor 8  and 8xj take 5-8 frames to load the whole clut in 8-bit mode (and suppress 5-8 vbl interrupts); the time is proportional to the number of clut entries being loaded. (Ok in 1-, 2-, and 4-bit modes.)
  17. •“RasterOps ColorBoard 264” (.RasterOps 1.2 264   Video Driver version 9327) takes 2 frames to load the clut (and suppresses 1 vbl interrupt) in 8- and 32-bit modes. (Ok in 1-, 2-, and 4-bit modes.)
  18. •RasterOps  “PaintBoard Li” 1.0 24XLi Video Driver takes 4 frames to load the clut (and suppresses 3 vbl interrupts)  in 8-,16-, and 32-bit modes. (Ok in 1-,2-, and 4-bit modes.) (Reported to RasterOps 12/30/92).
  19. •“RasterOps 8XL” (.RasterOps 1.2 8XL Video Driver version 9327) takes 4 frames to load the clut (and suppresses 3 vbl interrupts) in 8-bit mode. (Ok in 1-,2-, and 4-bit modes.)
  20. •"RasterOps 24XLTV" (.RasterOps 1.4 24XLTV Video Driver version 9327) takes 4 frames to load the clut (and suppresses 3 vbl interrupts) in 8- and 32-bit modes. (Ok in 1-,2-, 4-, and 16-bit modes.)
  21. •RasterOps "PaintBoard Turbo XL" (.RasterOps 1.0 PBTurboXL Video Driver version 9327) takes 4 frames to load the clut (and suppresses 3 vbl interrupts).
  22. •“Spectrum/8•24 PDQ” (.Display_Video_Apple_SpecRice version 3) takes 4 frames to load the clut in all modes.
  23.  
  24. 3. The following cards and drivers issue multiple VBL interrupts per frame, whereas they should emit exactly one per frame. Try TimeVideo.
  25. •The 4•8 and 8•24 “Macintosh Display Card” (.Display_Video_Apple_MDC) emit several VBL interrupts per video frame. (Reported to Apple.Bugs 12/30/92)
  26. •Apple Quadra 700 "Macintosh E Built-In Video" (.Display_Video_Apple_DAFB) emits 2 VBL interrupts per frame if the processor cache is enabled, but emits only 1, as it's supposed to, if the processor cache is disabled. (Reported by Kyle Cave, cavekr@ctrvax.vanderbilt.edu)
  27. •Apple Quadra 900 “Macintosh C Built-In Video” (.Display_Video_Apple_DAFB) occasionally emits more than 1 VBL interrupt per frame. 
  28. •Apple Quadra 950 “Macintosh G Built-In Video” (.Display_Video_Apple_DAFB version 2)  emits 2 or 3 VBL interrupts per frame. (Reported to Apple.Bugs 12/30/92)
  29. •Note that the .Display_Video_Apple_DAFB version 3 driver does NOT exhibit this bug, at least on the Centris 650 where it resides. It would be interesting to try copying this driver to the afflicted Quadra's, adapting the instructions given above for copying a driver from the IIsi to the IIci.
  30.  
  31. 4. 16 & 32-bit modes. These video drivers will correctly load the whole clut, but screw up if asked to load one clut entry at a time. The problems only occur in 16- and 32-bit mode. Apparently few or no applications (other than TimeVideo) ever do this, as otherwise the manufacturers would have detected the fault.
  32. •TrueVision NuVista version 3.0 GDDirectSetEntries (i.e. 16- and 32-bit pixel modes) loads garbage unless “start” is zero. GDSetEntries (i.e. 1-, 2-, 4-, and 8-bit pixel modes) works fine. 
  33. •RasterOps "PaintBoard Turbo XL" (.RasterOps 1.0 PBTurboXL Video Driver version 9327) crashes when attempting to serially load the CLUT in 16-bit mode.
  34.  
  35. 5. Other bugs:
  36. •“Truevision NuVista+™ Card” (.Display_Video_NuVista version ??) fails all CLUT-readback tests. Reported by David Rose <PSY009@sysh.surrey.ac.uk> on 8/94.
  37. •“Radius PowerView” (.Radius PowerView Display version 9848) calling GetGamma returns a gamma table that's all zero. (Reported to Radius 7/93)
  38. •“SuperMac ColorCard” v1.97S (.Display_SuperMac_ColorCard version 1) does not implement the gamma table, so GDSetGamma and GDGetGamma both return error codes. This is not a problem if what you want is a linear gamma table (i.e. no
  39. gamma translation), as is routinely requested by calling GDSetLinearGamma.
  40. •If the “Radius PrecisionColor 8” and “Radius PrecisionColor 8Xj” sense a monochrome monitor then they always operate in "gray" mode, even though the driver allows you to set and read the color/gray bit. Try TimeVideo.
  41. •Relax 19" Model 200 (.Color_Video_Display version 9288) doesn't support the optional getGamma Status call. The required getPageCnt (aka getPages) Status call erroneously returns a page count of 0 for all modes. Try TimeVideo or TestGDVideo. (Reported to Relax Tech. 1/19/93)
  42. •TrueVision NuVista version 3.0 can't display MacsBug.
  43. •The presence of the 8•24GC accelerator seems to HALVE the speed of CopyBits, at least on a RasterOps 8XL running on a Mac IIfx. CopyBitsQuickly is unaffected, of course.
  44. •“Spectrum/8•24 PDQ” (.Display_Video_Apple_SpecRice version 3) failed all read-write tests of clut when in 16-bit-pixel mode.
  45.  
  46. 6. Video drivers that have been tested (version 0, unless noted otherwise):
  47. Apple “Toby frame buffer card” (.Display_Video_Apple_TFB versions 4, 5, & 6)
  48. Apple “Mac II High-Resolution Video Card” (.Display_Video_Apple_HRVC)
  49. Apple 8•24 “Macintosh Display Card” (.Display_Video_Apple_MDC)
  50. Apple “Macintosh Display Card 8•24 GC” (.Display_Video_Apple_MDCGC)
  51. Apple Mac Plus “1-bit QuickDraw”
  52. Apple Mac SE “1-bit QuickDraw”
  53. Apple Mac Portable “1-bit QuickDraw”
  54. Apple Mac Centris 650 “Macintosh I Built-In Video” (.Display_Video_Apple_DAFB v. 3)
  55. Apple Mac Centris 660AV “Macintosh 3B” (.Display_Video_Apple_Civic)
  56. Apple Mac Classic II “Macintosh F Built-In Video” (.Display_Video_Apple_Apollo)
  57. Apple Macintosh LC III “Macintosh AA Built-In Video” (.Display_Video_Apple_Sonora)
  58. Apple “Macintosh SE/30 Internal Video” (.Display_Video_Apple_MacSE/30 Video)
  59. Apple Mac IIci “Macintosh II Built-In Video” (.Dksplay_Video_Apple_RBV1 vers. 0 & 1)
  60. Apple Mac IIsi “Macintosh A Built-In Video” (.Display_Video_Apple_RBV1 version 1)
  61. Apple Mac LC 475 “MEMCjr Built-In Video” (.Display_Video_Apple_DAFB version 5)
  62. Apple PowerBook 160 “Macintosh J Built-In Video”(.Display_Video_Apple_DBLite v. 1)
  63. Apple PowerBook 160 “Macintosh A External Video”(.Display_Video_Apple_ViSC)
  64. Apple PowerBook 170 “Macintosh D Built-In Video” (.Display_Video_Apple_TIM)
  65. Apple PowerBook 180 “Macintosh A External Video” (.Display_Video_Apple_ViSC)
  66. Apple PowerBook 180 “Macintosh J Built-In Video” (.Display_Video_Apple_DBLite v. 1)
  67. Apple Power Macintosh 7100/66 "Built-In VRAM Video" (.Display_Video_Apple_HPV_PDS v. 1)
  68. Apple Power Macintosh 8100/80 "Built-In VRAM Video" (.Display_Video_Apple_HPV_PDS v. 1)
  69. Apple Power Macintosh 8100/80 "Built-In DRAM Video" (.Display_Video_Apple_Sonora v. 2)
  70. Apple Quadra 630 "Valkyrie Built-In Video" (.Display_Video_Apple_Valkyrie)
  71. Apple Quadra 660AV "Macintosh 3B" (.Display_Video_Apple_Civic)
  72. Apple Quadra 700 “Macintosh E Built-In Video” (.Display_Video_Apple_DAFB)
  73. Apple Quadra 840AV “Macintosh 3A” (.Display_Video_Apple_Civic v. 0 and 2)
  74. Apple Quadra 900 "Macintosh C Built-In Video" (.Display_Video_Apple_DAFB)
  75. Apple Quadra 950 “Macintosh G Built-In Video” (.Display_Video_Apple_DAFB v. 1 & 2)
  76. Ehman “15" Full Page Video Card...”(.Lapis DisplayServerT II Rev 1.0)
  77. E-Machines "ColorLink_ SX-T" (.Display_Video_Apple_EM_10T version 5376)
  78. Lapis “Dual Page Video 1024x768” (.Lapis DisplayServer™ II Rev 1.0)
  79. “Radius PowerView” (.Radius PowerView Display version 9848)
  80. Radius PrecisionColor 8 (.Radius PrecisionColor 8)
  81. “Radius PrecisionColor 8Xj” (.Radius PrecisionColor 8Xj)
  82. “RasterOps ColorBoard 264” (.RasterOps 1.2 264   Video Driver version 9327)
  83. RasterOps “PaintBoard Li” (.RasterOps 1.0 24XLi Video Driver version 9327)
  84. RasterOps “ProColor 32” (.RasterOps 1.0 32XL Video Driver version 9327)
  85. “RasterOps 8XL” (.RasterOps 1.2 8XL Video Driver version 9327)
  86. RasterOps 24 L (.RasterOps 1.0 24 L Video Driver)
  87. "RasterOps 24XLTV" (.RasterOps 1.4 24XLTV Video Driver version 9327)
  88. RasterOps "PaintBoard Turbo XL" (.RasterOps 1.0 PBTurboXL Video Driver version 9327)
  89. “Relax 19" Model 200” (.Color_Video_Display version 9288)
  90. “Spectrum/8•24 PDQ” (.Display_Video_Apple_SpecRice version 3)
  91. “SuperMac ColorCard” v1.97S (.Display_SuperMac_ColorCard version 1)
  92. “Truevision NuVista™ Card” (.Display_Video_NuVista version 3.0)
  93. “Truevision NuVista+™ Card” (.Display_Video_NuVista version ??)
  94.  
  95. CONTRIBUTORS TO THIS DOCUMENT
  96. Ken Alexander <U12940@UICVM.BITNET> (E-Machines "ColorLink_ SX-T")
  97. Mike.Alexander@um.cc.umich.edu (RasterOps ColorBoard 264)
  98. David Brainard, brainard@condor.psych.ucsb.edu (Quadra 900, 8•24GC, RasterOps 24XLTV, RasterOps PaintBoard Turbo XL).
  99. Thomas Busey <busey@u.washington.edu> (RasterOps 8XL, Power Mac 8100/80, SuperMac ColorCard)
  100. Kyle Cave, cavekr@ctrvax.vanderbilt.edu (Ehman 15", Quadra 700)
  101. Kaan Erdener, kerdener@ptnext.pitzer.edu (Quadra 660AV)
  102. Bart Farell (Quadra 840av)
  103. mike_garver@isr.syr.edu (Lapis Dual Page Video, Spectrum/8•24 PDQ)
  104. Tony Hayes (PowerBook 180)
  105. Jan Linder <Jannl@aol.com> (Quadra 630)
  106. David Rose <PSY009@sysh.surrey.ac.uk> (TrueVision NuVista+)
  107. Steve Shevell <shevell@uchicago.edu> (RasterOps “Paintboard Turbo XL”)
  108. Scott B. Stevenson <stevenso@garnet.berkeley.edu> (Power Macintosh 8100/80)
  109. Marty Wachter <mrw@welchgate.welch.jhu.edu> (Quadra 840AV)
  110. Wei Xie (E-Machines "ColorLink_ SX-T")
  111.  
  112. Please send any corrections or additions to denis_pelli@isr.syr.edu